<TITLE>setlocale</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>SETLOCALE(3)        Linux Programmer's Manual        SETLOCALE(3)
</h3>

<h3>NAME
</h3>       setlocale - set the current locale.

<h3>SYNOPSIS
</h3>       #include &lt;locale.h&gt;

       char *setlocale(int category, const char * locale);

<h3>DESCRIPTION
</h3>       The  setlocale() function is used to set or query the pro-
       gram's current locale.  If locale is "C" or  "POSIX",  the
       current locale is set to the portable locale.

       If  locale  is "", the locale is set to the default locale
       which is selected from the environment variable LANG.

       On startup of the main program, the portable "C" locale is
       selected as default.

       The  argument  category  determines  which  functions  are
       influenced by the new locale:

       LC_ALL for all of the locale.

       LC_COLLATE
              for the functions strcoll() and strxfrm().

       LC_CTYPE
              for the  character  classification  and  conversion
              routines.

       LC_MONETARY
              for localeconv().

       LC_NUMERIC
              for the decimal character.

       LC_TIME
              for  strftime().  NULL if the request cannot not be
              honored.  This string may be  allocated  in  static
              storage.

       A  program  may be made portable to all locales by calling
       setlocale(LC_ALL, "" ) after program   initialization,  by
       using  the  values  returned  from a localeconv() call for
       locale - dependent information and by using  strcoll()  or
       strxfrm() to compare strings.

<h3>CONFORMS TO
</h3>       ANSI C, POSIX.1

       Linux  supports  the  portable locales "C" and "POSIX" and
       also the  European  Latin-1  "ISO-8859-1"  ,  and  Russian
       "KOI-8" locales.



<h3>GNU                       April 18, 1993                        1
</h3>




<h3>SETLOCALE(3)        Linux Programmer's Manual        SETLOCALE(3)
</h3>

       The  printf() family of functions may or may not honor the
       current locale.

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=locale.htm>locale</a>, 
<a href=localedef.htm>localedef</a>, 
<a href=strcoll.htm>strcoll</a>, 
<a href=isalpha.htm>isalpha</a>, 
<a href=conv.htm>conv</a>, 
<a href=strftime.htm>strftime</a>, 
<a href=locale.htm>locale</a>, 
<pre>



















































<h3>GNU                       April 18, 1993                        2
</h3>

</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>
